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1 About the Tutorials 





SilverStream eXtend Workbench provides tutorials to help you get started with Workbench 
projects and different types of J2EE applications. 


Availability of the tutorials 
SilverStream eXtend Workbench includes two tutorials: 


e Working with Web Services 


Illustrates how to create a Workbench project for a Web Service and use the Web Service 
Wizard to generate the Java and XML for the Web Service. It also describes how to create 
a J2EE WAR client application for the Web Service and demonstrates the Registry 
Browser and WSDL Editor. 


e Developing a Web Application 


Illustrates how to create a Workbench project for a WAR and how to use the Model-View- 
Controller (MVC) architecture to process user actions, data, and forms. 


The tutorial has two parts: 


e Part I shows you how to use Workbench to develop the sample Web application and 
how the MVC architecture is used in a Struts application. 


e Part IT teaches you how to write code in a Struts Web application that accesses data via 
the J2EE application server’s connection pool and how to define forms that display that 
data. 


Software requirements 


SilverStream eXtend Workbench To develop the tutorial applications, you need 
SilverStream eXtend Workbench. If you don’t have it already (you are reading this from the 
SilverStream Web site), you can get the Workbench software at the Workbench Web page at 
http://www.silverstream.com/workbench. You will be asked to register, and then you can 
download the software. 


A J2EE application server anda DBMS To run the tutorial applications, you need a 
J2EE application server for deploying the application. Some tutorials also need a DBMS for 
data storage. 





1 About the Tutorials 





e Ifyou already have a J2EE application server, you can deploy the standards-based J2EE 
WARs to your application server using either the Workbench deployment commands or 
your server’s deployment tools. 


e Ifyou don’t have the required application server and/or DBMS, you can download the 
trial version of the SilverStream eXtend Application Server (which includes the 
Cloudscape DBMS) from www.silverstream.com/downloads or the Workbench Web page 
mentioned above. For the tutorials, all you need is the Lite Edition (J2EE server and 
Cloudscape). 





2 Software requirements 





2 Workbench Deployment Instructions 





Purpose of these instructions 


SilverStream eXtend Workbench supports deployment to several different servers. It would 
make each tutorial too long to cover all those servers in detail in each situation. These 
instructions provide the detail, and the individual tutorials remind you of the commands to use 
and the information you need to supply. 


You can refer to these instructions whenever you need server-specific information to 
supplement the deployment instructions in a tutorial. 


NOTE Refer to these instructions after you have created your tutorial project and are ready to 
deploy it. 


Setting up your deployment environment 


Using Workbench, you can create J2EE applications for any J2EE application server. For 
several popular application servers, Workbench supports deployment directly with a Deploy 
Archive menu item. For other J2EE application servers, you can build your archive in 
Workbench and use your server’s deployment tools to deploy. As long as you stick to JZEE 
standards and avoid server-specific code, archives built by Workbench are completely J2EE- 
compatible and can be deployed to any J2EE server. 


NOTE Be sure to check the Release Notes for additional deployment information. 
Setting up and deploying consists of these tasks: 


Defining a server profile 
Preparing the runtime deployment information expected by your server 


Specifying deployment settings 


Pose os 


Deploying the archive 
The following sections provide instructions for these tasks: 


e Defining a server profile 

e Deploying to the SilverStream eXtend Application Server 
e Deploying to the Sun Reference Implementation server 

e Deploying to the Jakarta Tomcat server 


e Deploying to the BEA WebLogic server 
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e Deploying to the IBM WebSphere server 
e Deploying to the Oracle9iAS server 


Deploying to other servers For other servers, use your own server tools to deploy the 
archive you’ ve built. 


Defining a server profile 


A server profile stores information about your application server, so you don’t have to provide 
the same information over and over again. You can use the same server profile for all the tutorial 
exercises. 


If you’ ve already created a profile for your server, skip to the deployment instructions for your 
server (listed in “Setting up your deployment environment” just above). 


Multiple profiles If you want to deploy to more than one server, you should create a profile 
for each one. For SilverStream servers, you may also find it useful to define more than one 
profile for the same server—for example, if you want to deploy to different databases. 
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n 


B 
EXERCISE 2-1: Create a server profile for your application server 
In this exercise you will create a server profile. 


1. Select Edit>Profiles from the menu. 


RZ -i 
Žž Profiles x] 

















Server Profiles are used at deployment. They specify the information 
necessary to deploy to a given server. 


Note: a server type is valid for the server version specified or greater, unless 
a higher numbered version is available. 


Profile name: | bt ] New... 





Server type: Edit... 
Server version: = 
Deployment tools directory: Delete | 
Rapid Deployment directory: 








Server specific information: 











f (OK) Cancel Help | Cancel) Help 


2. On the Servers tab of the Profiles dialog, click New. 
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3. 


Fill in the Create a New Server Profile dialog with values like these (not all fields are 
present for all server types): 





Option 


Description 





Profile name 


Specify a name like SilverStream 373 Tutorial or RI Tutorial 





Server type 


Choose the type that describes your server and version 


Server types are organized by brand and version number. The 
version number indicates the lowest version supported by a 
given server type. A server type is often valid for multiple 
subsequent versions as well. 


As a rule, you should select the server type for your brand that 
is closest to the target server’s version, without being higher. 
For example, if your target is Version 3.7.5 of the SilverStream 
eXtend Application Server, the server type to select is 
SilverStream 3.7.4 or higher. 





Deployment tools 
directory 


Specify the directory that contains the server’s deployment 
tools; typically, a path like c:\SilverStream37\bin or 
c:\j2eesdk\bin 


If the server is located on another machine, you need either 
network access for running the tools or a copy of the tools in a 
local directory. For some servers, Workbench doesn’t support 
remote deployment. 





Rapid deployment 
directory 








Leave blank. Rapid deployment is not used in the tutorials. 
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4. Specify server-specific information. For most servers, you specify only the server name 
and port number. 





Option Description 





Server name Specify the name of your server, which could be localhost (or 
the actual server name for your server) 


If your server is not using the default port 80, specify 
server-name:port-number 


For example, your server might be localhost:8080 





Database name (SilverStream only) Specify the name of a database on your 
server for the archive to be deployed into 


NOTE The Proverbs Web application (the WAR tutorial 
application) has a database for the application’s data. 
You can deploy any of the tutorial archives to that 
database. If you have set up the Cloudscape database 
provided with the tutorial files, specify ProverbsCloud. 
If you used the SQL script to create a database, specify 
its name. For database setup procedures, see Lesson 2 in 
the WAR tutorial. 














A filled-in dialog for a SilverStream server looks something like this: 


Žž% Create a New Server Profile x] 
Profile name: BilverStreama7Tut 














Server type: [EilverStream 37.3 z] 
Server version: 3.7.3 
Deployment tools directory: Fo silverstream37\bin Browse... | 


Rapid Deployment directory: | Browse... | 
Server specific information: 


Server name: Jocalhost 
Database name: ProverbsCloud 


Cancel 











Help 





5. Click OK to close both the Create a New Server Profile dialog and the Profiles dialog. 
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Deploying to the SilverStream eXtend Application Server 


To deploy to the SilverStream eXtend Application Server from Workbench, you create a server 
profile (described in “Defining a server profile” on page 4) and a deployment plan. Then you 
deploy the archive. 


This is what you’ll do: 


e EXERCISE 2-2: “Create a deployment plan for the SilverStream server” 
e EXERCISE 2-3: “Specify deployment settings” 
e EXERCISE 2-4: “Deploy the application to the SilverStream server” 


About the deployment plan The deployment plan specifies actual values for names 
identified in the deployment descriptor. Before you can create the deployment plan, you must 
have built the archive and added appropriate items to the descriptor. If you change the descriptor 
later, Workbench modifies the plan to match when you open it in the editor. 


EXERCISE 2-2: Create a deployment plan for the SilverStream server 
In this exercise you will create a SilverStream deployment plan. 


1. If the SilverStream server isn’t running, start it now. 


2. With your tutorial project open in Workbench, select File>New from the menu. 
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3. Inthe New File dialog, select the J2EE tab; then select SilverStream Deployment Plan 


and click OK. 


Choose file type: 
2EE | Web Services | XML | 








F EJB Servlet 
Create a new Enterprise JavaBean Create a new Servlet 

w JSP a Java file 
Create a new JavaServer Page Create a new Java class file 

Ka JavaBean {a} Tag handler 
Create anew JavaBean class file Create or modify a Tag handler library 
Generic text file SilverStream Deployment Plan 
Create a generic empty file ~ Create a new SilverStream deployment plan 








(aa) Deployment Descriptor 


Create a new deployment descriptor 





fi Use wizard 
E OK Cancel. Help 





4. Inthe Select Project text box of the Select Project For Deployment Plan dialog, accept the 
default project name—the only open project. 


5. In the Select destination server type list box, select the version of your SilverStream 
server. Then click OK. 


y Select Project For Deployment Plan x| 


Select project: 












Select destination server type: 


[Siiverstream 3.7.3 7] 


D OK Cancel | 


6. If Workbench displays the Select Build Option dialog, accept the defaults and click OK. 


The deployment plan displays in the Edit Pane. It includes a top-level element that 
corresponds with your project type. If there were elements in the deployment descriptor 
such as resource references, for each one you would see a corresponding element where 
you could provide its value. 
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7. Choose File>Save to save the deployment plan. In the Save As dialog, give the plan a 
name like myprojectDepI|Plan.xml, where myproject is a name related to your tutorial 
project, and save it in the project’s root directory. 


8. Right-click the top-level archive element and select Properties from the popup menu. 


The property sheet displays properties of the deployment plan. 





Deployment Plan | 
Enabled: @ True © False 
WAR Name: 


C:WVorkbenchProjects'ProverbStart'ProverbStart we 
Deployed object name: 


ProverbStart 
Server Profile: SiverStreama7Tut =| 


Session timeout in deployment descriptor (minutes): 
5 
Overridden session timeout in deployment plan: 


= 


=IURLs: 
ProverbStart 
Edit URLs 
=| Excluded JSPs: = —— 





= Uses JARs: 
Edit Uses 





Edit Userlib JARs List 








9. Set values on the property sheet using the values listed in your tutorial. 


10. Save again and close the Deployment Plan Editor. 


E 
EXERCISE 2-3: Specify deployment settings 


In this exercise you will specify the deployment settings that will be used each time you deploy 
while you are developing and testing your tutorial application. 
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1. With your tutorial project open in Workbench, select Project>Deployment Settings from 
the menu. 


ZZ Deployment - [C:\wWorkbenchProjects\ProverbStart\Proverb... E4 


Server Profiles | Deployment Info | 


Deployment dialog contains the information to deploy a J2EE application. An 
install directory is the place where deployment tools can be found for the 
given server. 


Server Profiles are used at deployment. They specify the information 
necessary to deploy to a given server. 


Note: a server type is valid for the server version specified or greater, 
unless a higher numbered version is available. 





Profile name: SiverStream37 Tut z] New... 
Server type: SilverStream 3.7.3 Edit... 
Server version: 3.7.3 

E eats i Delete 
Deployment tools directory: c:\silverstream37 bin = 
Rapid Deployment directory: 


Server specific information: 
Server name: localhost 
Database name: ProverbsCloud 








|v) Save this profile as defaut 


User name: | 
Password: | 





Deploy Help 


2. On the Server Profiles tab of the Deployment dialog, the profile you created in 
EXERCISE 2-1: “Create a server profile for your application server” should be selected. If 
it isn’t, select it now. 


Values from the profile are displayed below the profile name. You can click New, Edit, or 
Delete to change any of the profile definitions. 


3. If you have a secure server, fill in the User name and Password text boxes with the user 
name and password for the server. 


4. Select the Deployment Info tab. 
5. Clear the Ignore compile errors check box. 
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6. Leave the other options as they are. In particular, do not check Enable Rapid 


Deployment. These instructions do not describe how to set up rapid deployment. 


3% Deployment - [C:\WorkbenchProjects\ProverbStart\Prove... x| 


Server Prones] Deployment Into | 


Enabling Rapid deploy creates the application under the application 
server's webapps directory. This is only recommended for testing and 


development. Please disable rapid deploy and do a full deploy in 
production environment. 


[T Enable Rapid Deployment. 


SilverStream Deployment Plan: 
ProverbStartWARDepPlan xml ey | 


[M Overwrite existing deployment Yerbosity: f3 z] 





SilverCmd Flags : | 





OK Cancel, Deploy Help 


7. Click OK to save the deployment settings. 


TIP You could also click Deploy, which does the same thing as the Deploy Archive menu 
item used in the next exercise. 


me 
EXERCISE 2-4: Deploy the application to the SilverStream server 


In this exercise you’ll deploy your project using the values you specified in the Deployment 
dialog. 


Select Project>Deploy Archive from the menu. 


Workbench displays progress messages, errors, and warnings in the Output Pane. 
TIP The deployment will fail if your server is not running. 
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Deploying to the Sun Reference Implementation server 


To deploy to the Reference Implementation, you create a server profile (described in “Defining 
a server profile” on page 4) and a runtime deployment descriptor in a format defined by Sun 
Microsystems. The descriptor becomes part of your project, and its archive location is the 
META-INF directory. 


This is what you’ll do: 

e EXERCISE 2-5: “Create a runtime deployment descriptor” 

e EXERCISE 2-6: “Include the WAR or EJB JAR in an EAR” 

e EXERCISE 2-7: “Specify deployment settings” 

e EXERCISE 2-8: “Deploy the application to the Reference Implementation server” 


Requirement Ifyou are deploying a WAR or an EJB, the Reference Implementation 
requires that the WAR be a module in an enterprise application archive (EAR). Then you specify 
deployment settings and deploy the EAR. 


About the runtime deployment descriptor The runtime deployment descriptor 
specifies actual values for names identified in the deployment descriptor. You can create the file 
in the Edit Pane. 


EXERCISE 2-5: Create a runtime deployment descriptor 


In this exercise you will create a new XML file for the Reference Implementation runtime 
deployment descriptor. 


1. With your project open in Workbench, select File>New from the menu. 
2. Inthe New File dialog, select Generic text file and click OK. 
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RZ m 
a New File x] 


Choose file type: 
J2EE | Web Services | ML | 


EJB Servlet 








Create a new Enterprise JavaBean Create a new Servlet 
JSP a} Java file 

Create a new JavaServer Page Create a new Java class file 
Ka} JavaBean {a} Tag handler 

Create a new JavaBean class file Create a new JSP tag handler 





abd Generic text file ee) SilverStream Deployment Plan 
Create a generic empty file Create a new SilverStream deployment plan 


Deployment Descriptor 
Create a new deployment descriptor 








OK Cancel Help 


Select File>Save. In the Save As dialog, create a new directory in your project’s root 
directory called META-INF. Save the file in that directory with the name sun-j2ee- 
ri.xml. 


To add the new file to the project, select Project>Add to Project>File. If necessary, 
navigate to the new directory. 


In the Add to Project dialog, select the file sun-j2ee-ri.xml and click Open. 


In the second Add to Project dialog, the correct values should already be set: Add the file 
to the archive at this location and META-INF/sun-j2ee-ri.xml. 


Click OK. 
In the Edit Pane, enter the XML for the descriptor, which looks something like this: 


<?xml version="1.0" encoding="Cp1252"?> 


<j2ee-ri-specific-information> 
<server-name></server-name> 
<rolemapping /> 
<web> 
<display-name>ProverbsStart</display-name> 
<context-root>ProverbsStart</context-root> 
<resource-ref> 
<res-ref-name>jdbc/ProverbsDB</res-ref-name> 
<jndi-name>ProverbsCloud</jndi-name> 
</resource-ref> 
</web> 
</j2ee-ri-specific-information> 


Typically, you will specify a display name, context root, and values for resource 
references, if any. Each tutorial has specific instructions for these values. 
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8. Save again and close the file. 


> 


[Bs 
EXERCISE 2-6: Include the WAR or EJB JAR in an EAR 


If the tutorial application is a WAR or an EJB JAR, you need to put the archive in an EAR before 
deploying. After you create the EAR, you can work with the tutorial project from within the 
EAR or you can close the EAR and open the individual project. 


1. Close the current project. 

2. Select File>New Project from the menu. 

3. In the New Project dialog, choose EAR Enterprise Archive and click OK. 
4. 


Specify a project name and location. The rest of the dialog is filled in automatically. In 
Project J2EE Version, specify j2ee 1.2 (ear 1.2) so the application will run on any server 
that supports J2EE 1.2. 


Enter the name and location (directory path) for 
the project, the archive file, and the deployment 
descriptor and select the desired J2EE version. 
(To use an existing archive as-is, create a 
deploy-only project instead.) 


Project Name: 


Proverbear 


Project Location: 


F:WorkbenchProjects'ProverbEAR E 


Archive Name (e.g. office.war): 


Proverbear 


Archive Location (directory): 


F:WorkbenchProjects\ProverbEAR u 





Deployment Descriptor Name: 


Fipplication xml 


Deployment Descriptor Location: 


F:WorkbenchProjects'ProverbEAR'META-INF H 
Project J2EE Version: fl2ee 1.2 (EAR 1.2) z] 








Next> Cancel Help 
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E 
EXERCISE 2-7: Specify deployment settings 


11. 


12. 


Click Next and then click Finish. 
Select Project>Add to Project>Subproject from the menu. 


In the Add to Project dialog, find the project root directory for the module you want to 
deploy, select the project file (it ends in SPF), and click Open. 


In the second Add to Project dialog, select these options: 

e Include in parent archive 

e Add the generated archive of the subproject to the parent archive 
e Add the child archive to the root of the parent archive 


ZZ Add to Project x] 
File: [:WorkbenchProjects'ProverbStart\ProverbStart spt 


Add to project: ProverbEAR z] 


|V Include in parent archive 













(@ Add the generated archive of the subproject to the parent archive. 
© Add the contents (individual files) of the subproject to the parent archive. 


( Add the child archive to the root of the parent archive. 


© Add the child archive at this location: | 









OK Cancel Help 





Open application.xml in the Deployment Descriptor Editor. 
The descriptor includes a WAR module that corresponds to the subproject you added. 


Right-click Enterprise Archive and select Properties. In the property sheet, specify a 
display name for the application. 


Select the WAR module. In the property sheet, specify a value for context root. Usually 
this is the same as the name of the archive. 


Save and close the file. 


In this exercise you will specify the deployment settings that are used each time you deploy 
while you are developing and testing your tutorial application. 


1. 


With your tutorial project open in Workbench, select Project>Deployment Settings from 
the menu. 
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3% Deployment - [C:\WorkbenchProjects\ProverbStart\ProverbS tart. war] x| 
Server Profiles | Deployment info | 


Deployment dialog contains the information to deploy a J2EE application. An install directory 
is the place where deployment tools can be found for the given server. 


Server Profiles are used at deployment. They specify the information necessary to 
deploy to a given server. 


Note: a server type is valid for the server version specified or greater, unless a higher 
numbered version is available. 


Profile name: [Eun Tutorial z] New... | 
Server type: Reference Implementation Edit... 
Server version: 1.0 

3 hy ee A Delete 
Deployment tools directory: c:\j2sdkee1.2.1 bin = 
Rapid Deployment directory: 


Server specific information: 


Server name: localhost 








IV Save this profile as defaut 


User name: | 
Password: | 





cel) Deploy Help 


2. On the Server Profiles tab of the Deployment dialog, the profile you created in 


EXERCISE 2-1: “Create a server profile for your application server” should be selected. If 
it isn’t, select it now. 


Values from the profile are displayed below the profile name. You can click New, Edit, or 
Delete to change the profile definitions. 


3. If you have a secure server, fill in the User name and Password text boxes with the user 
name and password for the server. 


You do not need to make any settings on the Deployment Info tab. These instructions do 
not describe how to set up rapid deployment. 


4. Click OK to save the deployment settings. 


TIP You could also click Deploy, which does the same thing as the Deploy Archive menu 
item used in the next exercise. 
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EXERCISE 2-8: Deploy the application to the Reference Implementation server 


In this exercise you’ll deploy your project using the values you specified in the Deployment 
dialog. 
1. Select Project>Deploy Archive from the menu. 

Workbench displays progress messages, errors, and warnings in the Output Pane. 

TIP The deployment will fail if your server is not running. 


2. Restart the server. 


Deploying to the Jakarta Tomcat server 


To deploy to Tomcat, you create a server profile (described in “Defining a server profile” on 
page 4). Then you specify deployment settings and deploy the archive. The name of the archive 
becomes the context path for the application. There is no server-specific deployment 
information. 


This is what you’ll do: 


e EXERCISE 2-9: “Specify deployment settings” 
e EXERCISE 2-10: “Deploy the application to the Tomcat server” 


Limitations Database connectivity, connection pools, and JNDI InitialContext are not 
supported by Tomcat Version 3.2.x, so these tutorials will not work: 


e Proverbs Web application requires database support 


e —CalcWARClient Web application requires JNDI support (CalcWARClient does work with 
Tomcat 4) 


EXERCISE 2-9: Specify deployment settings 


In this exercise you will specify the deployment settings that will be used each time you deploy 
while you are developing and testing your tutorial application. 


1. With your tutorial project open in Workbench, select Project>Deployment Settings from 
the menu. 
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3% Deployment - [C:\WorkbenchProjects\ProverbStart\ProverbStart. war] x] 


Server Profiles | Deployment Info | 

















Deployment dialog contains the information to deploy a J2EE application. An install directory 
is the place where deployment tools can be found for the given server. 


Server Profiles are used at deployment. They specify the information necessary to 


deploy to a given server. 


Note: a server type is valid for the server version specified or greater, unless a higher 
numbered version is available. 


Profile name: [Tomcat Tutorial z] 





Server type: Tomcat 3.2.1 


Server version: 3.21 
Deployment tools directory: c:\Jakarta\Tomeat\jakarta-tomcat-3.2.1 bin Delete | 
Rapid Deployment directory: 


Server specific information: 
Server name: http:Mocalhost:8080 








IV Save this profile as defaut 


User name: | 
Password: | 





GK Cancel) Deploy Help 


2. On the Server Profiles tab of the Deployment dialog, the profile you created in 
EXERCISE 2-1: “Create a server profile for your application server” should be selected. If 
it isn’t, select it now. 


Values from the profile are displayed below the profile name. You can click New, Edit, or 
Delete to change the profile definitions. 


3. If you have a secure server, fill in the User name and Password text boxes with the user 
name and password for the server. 


You do not need to make any settings on the Deployment Info tab. These instructions do 
not describe how to set up rapid deployment. 


4. Click OK to save the deployment settings. 


TIP You could also click Deploy, which does the same thing as the Deploy Archive menu 
item you'll use in the next exercise. 
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EXERCISE 2-10: Deploy the application to the Tomcat server 


In this exercise you’ll deploy your project using the values you specified in the Deployment 
dialog. 


1. Select Project>Deploy Archive from the menu. 


Workbench displays progress messages, errors, and warnings in the Output Pane. 


2. Restart the Tomcat server. 


Deploying to the BEA WebLogic server 


To deploy to the BEA WebLogic server, you create a server profile (described in “Defining a 
server profile” on page 4) and the weblogic.xml file that defines runtime information for the 
application. Then you specify deployment settings and deploy the archive. 


This is what you’ll do: 


e EXERCISE 2-11: “Create a WebLogic deployment descriptor” 
e EXERCISE 2-12: “Specify deployment settings” 
e EXERCISE 2-13: “Deploy the application to the BEA WebLogic server” 


EXERCISE 2-11: Create a WebLogic deployment descriptor 
In this exercise you will create a new XML file for the WebLogic deployment descriptor. 


1. With your project open in Workbench, select File>New from the menu. 
2. Inthe New File dialog, select Generic text file and click OK. 
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RZ p 
a New File x] 


Choose file type: 
J26E | We Services ML] 















Servlet 





* Create a new Enterprise JavaBean Create a new Servlet 


W JSP {a} Java file 


Create a new JavaServer Page Create a new Java class file 


g JavaBean jaj Ts handler 
Create a new JavaBean class file Create a new JSP tag handler 





abd Generic text file SilverStream Deployment Plan 
Create a generic empty file Create a new SilverStream deployment plan 


(aa) Deployment Descriptor 


Create a new deployment descriptor 















4 OK Cancel Help 


3. Select File>Save. In the Save As dialog, save the file in the project’s WEB-INF directory 
with the name weblogic.xml. 


TIP Ifthe WEB-INF directory is already part of the project, the new file is included in the 
archive automatically. 


4. Inthe Edit Pane, enter the XML for the descriptor. 


Typically, you will specify a display name, context root, and values for resource 
references, if any. Each tutorial has its own values for these elements. 


The XML looks something like this: 


<!DOCTYPE weblogic-web-app PUBLIC "-//BEA 
Systems, Inc.//DTD Web Application 6.0//EN" 
"http: //www.bea.com/servers/wls610/dtd/ weblogic-web-jar.dtd"> 


<weblogic-web-app> 
<description> 
Text description of the Web App 
</description> 
<weblogic-version> 
</weblogic-version> 


<reference-descriptor> 
<resource-description> 
<res-ref-name>jdbc/ProverbsDB</res-ref-name> 
<jndi-name>ProverbsCloud</jndi-name> 
</resource-description> 
</reference-descriptor> 
</weblogic-web-app> 
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> 


B 


LL) For more information about the WebLogic descriptor, see Writing Web Application 
Deployment Descriptors in the WebLogic documentation set. 


Save again and close the file. 


EXERCISE 2-12: Specify deployment settings 


2. 


In this exercise you will specify the deployment settings that will be used each time you deploy 
while you are developing and testing your tutorial application. 


With your tutorial project open in Workbench, select Project>Deployment Settings from 
the menu. 


ZZ Deployment - [C:\WorkbenchProjects\ProverbStart\ProverbS tart. war] x] 
Server Profiles | Deployment Info | 


Deployment dialog contains the information to deploy a J2EE application. An install directory 
is the place where deployment tools can be found for the given server. 


Server Profiles are used at deployment. They specify the information necessary to 
deploy to a given server. 


Note: a server type is valid for the server version specified or greater, unless a higher 
numbered version is available. 





Profile name: [WebLogic Tutorial z] New... 
Server type: WebLogic 6.0 Edit... 
Server version: 6.0 

j A i Delete 
Deployment tools directory: c:bealwiserver6.0sp1 ‘bin = 
Rapid Deployment directory: 


Server specific information: 


Server name: http: localhost: 7001 
Target Servers : 








IV Save this profile as defaut 


User name: | 


Password: | 





OK Cancel Deploy Help 


On the Server Profiles tab of the Deployment dialog, the profile you created in 


EXERCISE 2-1: “Create a server profile for your application server” should be selected. If 
it isn’t, select it now. 


Values from the profile are displayed below the profile name. You can click New, Edit, or 
Delete to change the profile definitions. 
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3. If you have a secure server, fill in the User name and Password text boxes with the user 
name and password for the server. 


4. Select the Deployment Info tab. 


5. Inthe WebLogic Application Name text box, type the name your users will use in the 
URL for the application. 


NOTE Do not check Enable Rapid Deployment. These instructions do not describe 
how to set up rapid deployment. 


6. Inthe Deployment Options list box, select deploy if you’re deploying the application for 
the first time. If a tutorial has you deploy the same application again, change the option to 
update. 


3% Deployment - [C:\WorkbenchProjects\ProverbEAR \ProverbEAR. ear] Eg 


Server Prones] Deployment into | 


| Enabling Rapid deploy creates the application under the application server's webapps 
| directory. This is only recommended for testing and development. Please disable rapid 
| deploy and do a full deploy in production environment. 


| [7 Enable Rapid Deployment. 


| WebLogic Application Name: 


ProverbStart 


Components and Targets : 


Generate Targets | 


Deployment Options : 
aeploy X | 
[T debug 


neel Deploy Help 





7. Click OK to save the deployment settings. 


TIP You could also click Deploy, which does the same thing as the Deploy Archive menu 
item you'll use in the next exercise. 
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EXERCISE 2-13: Deploy the application to the BEA WebLogic server 


In this exercise you’ll deploy your project using the values you specified in the Deployment 
dialog. 
e Select Project>Deploy Archive from the menu. 

Workbench displays progress messages, errors, and warnings in the Output Pane. 


TIP The deployment will fail if your server is not running. 


Deploying to the IBM WebSphere server 


To deploy to the IBM WebSphere server, you create a server profile (described in “Defining a 
server profile” on page 4) and specify deployment information. Then you specify deployment 
settings and deploy the archive. 


This is what you’ll do: 


e EXERCISE 2-14: “Specify runtime deployment information” 
e EXERCISE 2-15: “Specify deployment settings” 
e EXERCISE 2-16: “Deploy the application to the IBM WebSphere server” 


Requirement The WebSphere server requires that you deploy an EAR, not a WAR or an 
EJB archive. For a WAR, Workbench will automatically create an EAR that includes the WAR 
when you deploy. 


EXERCISE 2-14: Specify runtime deployment information 


In this exercise you will create a new XML file for the WebSphere runtime deployment 
descriptor. Your J2EE application may not require this file. 


1. With your project open in Workbench, select File>New from the menu. 
2. Inthe New File dialog, select Generic text file and click OK. 
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RZ p 
a New File x] 


Choose file type: 
J26E | We Services ML] 












=) EJB Servlet 
" Create a new Enterprise JavaBean Create a new Servlet 
W JSP {a} Java file 
Create a new JavaServer Page Create a new Java class file 
Ka JavaBean {a} Tag handler 
Create anew JavaBean class file Create a new JSP tag handler 





abd Generic text file SilverStream Deployment Plan 
Create a generic empty file Create a new SilverStream deployment plan 


(aa) Deployment Descriptor 


Create a new deployment descriptor 















fi Use wizard 
j OK Cancel! Help 





3. Select File>Save. In the Save As dialog, save the file in the project’s WEB-INF directory 
with the name expected by the WebSphere server. 


TIP Ifthe WEB-INF directory is already part of the project, the new file will be included 
in the archive automatically. 


4. Inthe Edit Pane, enter the XML for the descriptor according to WebSphere requirements. 


5. Save again and close the file. 


[bs 
EXERCISE 2-15: Specify deployment settings 


In this exercise you will specify the deployment settings that will be used each time you deploy 
while you are developing and testing your tutorial application. 


1. With your tutorial project open in Workbench, select Project>Deployment Settings from 
the menu. 
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3% Deployment - [C:\WorkbenchProjects\ProverbStart\ProverbS tart. war] x] 
Server Profiles | Deployment Info | 


Deployment dialog contains the information to deploy a J2EE application. An install directory 
is the place where deployment tools can be found for the given server. 


Server Profiles are used at deployment. They specify the information necessary to 
deploy to a given server. 


Note: a server type is valid for the server version specified or greater, unless a higher 
numbered version is available. 





Profile name: [WebSphere Tutorial z] New 
Server type: WebSphere 4.0 Edit... 
Server version: 40 

j = i Delete 
Deployment tools directory: c:\websphere'bin = 
Rapid Deployment directory: 


Server specific information: 


Server name: localhost:9080 











M Save this profile as defaut 


User name: | 
Password: | 





OK) Cancel) Deploy Help 


2. On the Server Profiles tab of the Deployment dialog, the profile you created in 
EXERCISE 2-1: “Create a server profile for your application server” should be selected. If 
it isn’t, select it now. 


Values from the profile are displayed below the profile name. You can click New, Edit, or 
Delete to change the profile definitions. 


3. If you have a secure server, fill in the User name and Password text boxes with the user 
name and password for the server. 


4. Select the Deployment Info tab. 
Leave the Node Name text box blank unless you have set up server nodes. 
6. Check Precompile JSP so compilation errors are reported when you deploy. 


NOTE Do not check Enable Rapid Deployment. These instructions do not describe 
how to set up rapid deployment. 
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¥ Deployment - [C:\WorkbenchProjects\ProverbEAR \Proverb... Eq 


Server Profiles) Deployment Into 


Enabling Rapid deploy creates the application under the application 
server's webapps directory. This is only recommended for testing and 


development. Please disable rapid deploy and do a full deploy in 
production environment. 


[7 Enable Rapid Deployment. 


WebSphere Deployment options : 


Node Name : | 


[V Precompile JSP 





OK Cancel) Deploy Help 


7. Click OK to save the deployment settings. 


TIP You could also click Deploy, which does the same thing as the Deploy Archive menu 
item you'll use in the next exercise. 


Z 


EXERCISE 2-16: Deploy the application to the IBM WebSphere server 


In this exercise yov’ ll deploy your project using the values you specified in the Deployment 
dialog. 


Select Project>Deploy Archive from the menu. 


Workbench displays progress messages, errors, and warnings in the Output Pane. 
TIP The deployment will fail if your server is not running. 
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Deploying to the Oracle9iAS server 


Vv. 


EXERCISE 2-17: Specify runtime deployment information 


To deploy to the Oracle9iAS server, you create a server profile (described in “Defining a server 
profile” on page 4) and specify deployment information. Then you specify deployment settings 
and deploy the archive. 


This is what you’ll do: 


EXERCISE 2-17: “Specify runtime deployment information” 
e EXERCISE 2-18: “Specify deployment settings” 


EXERCISE 2-19: “Deploy the application to the Oracle9iAS server” 


Requirement The Oracle server requires that you deploy an EAR, not a WAR or EJB 


archive. For a WAR, Workbench will automatically create an EAR that includes the WAR when 
you deploy. 


In this exercise you will create a new XML file for the Oracle runtime deployment descriptor. 
1. With your project open in Workbench, select File>New from the menu. 
2. Inthe New File dialog, select Generic text file and click OK. 


3% New File Eg 
Choose file type: 


J2EE |Web Services | XML | 





F EJB Servlet 
Create a new Enterprise JavaBean Create a new Servlet 
JSP t Java file 
Create a new JavaServer Page Create a new Java class file 


JavaBean {a} Tag handler 
Create a new JavaBean class file Create a new JSP tag handler 


abd Generic text file ee) SilverStream Deployment Plan 
Create a generic empty file Create a new SilverStream deployment plan 
(aa) Deployment Descriptor 
Create a new deployment descriptor 











OK Cancel Help 
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3. Select File>Save. In the Save As dialog, save the file in the project’s WEB-INF directory 
with the name expected by the Oracle server. 


TIP Ifthe WEB-INF directory is already part of the project, the new file will be included 
in the archive automatically. 


4. Inthe Edit Pane, enter the XML for the descriptor according to Oracle requirements. 


5. Save again and close the file. 


By 
EXERCISE 2-18: Specify deployment settings 


In this exercise you will specify the deployment settings that will be used each time you deploy 
while you are developing and testing your tutorial application. 


1. With your tutorial project open in Workbench, select Project>Deployment Settings from 
the menu. 


3 Deployment - [C:\WorkbenchProjects\ProverbStart\ProverbS tart. war] x| 


Server Profiles | Deployment info | 
Deployment dialog contains the information to deploy a J2EE application. An install directory 
is the place where deployment tools can be found for the given server. 


Server Profiles are used at deployment. They specify the information necessary to 
deploy to a given server. 


Note: a server type is valid for the server version specified or greater, unless a higher 
numbered version is available. 





Profile name: [oracle Tutorial z] New... | 
Server type: OraclegiAS 1.0.2.2 Edit 
Server version: 1.0.2.2 
Deployment tools directory: c:\oracleSias\j2ee\homellip Delete | 
Rapid Deployment directory: 


Server specific information: 
Server name: http: Mocalhost:8888 








[V Save this profile as defaut 


User name: | 
Password: | 


sancel| Deploy Help 
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6. 


On the Server Profiles tab of the Deployment dialog, the profile you created in 
EXERCISE 2-1: “Create a server profile for your application server” should be selected. If 
it isn’t, select it now. 


Values from the profile are displayed below the profile name. You can click New, Edit, or 
Delete to change the profile definitions. 


If you have a secure server, fill in the User name and Password text boxes with the user 
name and password for the server. 


Select the Deployment Info tab. 

For Deployment Name, specify the name of the archive. Leave the other options as is. 

NOTE Do not check Enable Rapid Deployment. These instructions do not describe 
how to set up rapid deployment. 

l 


Server Profiles 





Enabling Rapid deploy creates the application under the application 
server's webapps directory. This is only recommended for testing and 
development. Please disable rapid deploy and do a full deploy in 
production environment. 


[7 Enable Rapid Deployment. 


OC4J Deployment options 

Deployment Name : ProverbEar 
Target Path : | 

Website Name : Pletautt-web-site 





OK Cancel Deploy Help 


Click OK to save the deployment settings. 


TIP You could also click Deploy, which does the same thing as the Deploy Archive menu 
item you'll use in the next exercise. 
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EXERCISE 2-19: Deploy the application to the Oracle9iAS server 


In this exercise yov’ ll deploy your project using the values you specified in the Deployment 
dialog. 
e Select Project>Deploy Archive from the menu. 

Workbench displays progress messages, errors, and warnings in the Output Pane. 


TIP The deployment will fail if your server is not running. 
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